Skip to main content
GET
/
api
/
v1
/
users
/
{address}
/
total_surplus
Get the total surplus earned by the user. [UNSTABLE]
curl --request GET \
  --url https://api.cow.fi/mainnet/api/v1/users/{address}/total_surplus
{
  "totalSurplus": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://cowswap-mintlify-docs-quality-audit-1774257282.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
address
string
required

20 byte Ethereum address encoded as a hex with 0x prefix.

Example:

"0x6810e776880c02933d47db1b9fc05908e5386b96"

Response

The total surplus.

The total surplus.

​
totalSurplus
string

The total surplus.

Last modified on March 23, 2026